После того как с помощью элемента управления MAPI Session установлен сеанс обмена сообщениями, элемент управления MAPI может выполнять разнообразные функции системы передачи сообщений.
Синтаксис
MapiMessages
Комментарии
Элемент управления MAPI Messages позволяет делать
следующее:
Получать доступ к сообщениям во входном ящике
пользователя.
Составлять новое сообщение.
Добавлять и удалять получателей
сообщений и присоединений к сообщениям.
Посылать сообщения (независимо от
поддержки пользовательского интерфейса).
Сохранять, копировать и удалять
сообщения.
Отображать диалоговое окно Address Book.
Отображать диалоговое
окно Details.
Получать доступ к присоединениям, в том числе к присоединениям
типа OLE Automation.
Разрешать имена получателей в процессе
адресования.
Отвечать на сообщения и переадресовывать их.
Большинство свойств элемента управления MAPI Messages можно отнести к
одной из четырех функциональных областей: свойства адресной книги, свойства
файлов присоединений, свойства сообщений и свойства получателей. Свойства файлов
присоединений, сообщений и получателей контролируются соответственно свойствами
AttachmentIndex, MsgIndex и RecipIndex.
Например, при изменении значения индекса в свойстве MsgIndex
изменяются и все остальные свойства сообщений, присоединений и получателей,
чтобы отразить характеристики заданного сообщения. Набор свойств сообщений
работает аналогично набору свойств получателей. Свойства адресной книги
определяют внешний вид диалогового окна Address Book.
Буферы сообщений
При использовании элемента управления MAPI Messages необходимо следить за двумя буферами: буфером редактирования и буфером чтения. Буфер чтения образуется из индексированного набора сообщений, выбранных из входного ящика пользователя. С помощью свойства MsgIndex можно получать доступ к отдельным сообщениям внутри этого набора, начиная с первого, которому соответствует индекс 0, и кончая последним (индекс при прохождении набора последовательно наращивается на единицу).
Набор сообщений строится с помощью метода Fetch. Такой набор включает
сообщения типа, определяемого свойством FetchMsgType, и сортируется в
соответствии с установкой свойства FetchSorted. Свойство
FetchUnreadOnly позволяет определить, включаются ли в набор ранее
прочитанные сообщения. Сообщения, находящиеся в буфере чтения, не могут быть
изменены пользователем, но их можно скопировать в буфер редактирования и там
изменить.
Сообщения можно создавать и редактировать в буфере редактирования. Буфер редактирования является активным, когда свойство MsgIndex имеет значение -1. Многие операции системы передачи сообщений допустимы только в буфере редактирования, например посылка сообщений, посылка сообщений из диалогового окна, сохранение сообщений, удаление получателей и присоединений.